Custom Clipping: Starting With the Curated Clip

Feed's Curation team has already selected and clipped the most impactful section of the song (we call this the Curated Clip). This is what's returned by a /music-fetch request. However you might want to allow your users to create their own Custom Clip. In this case, you'll:

1. Use /track-fetch to access the full track for clipping.
2. Provide a UI to let your user to select their desired clip (up to 1 min in length).
3. Request that Custom Clip from our API via a /clip request.
4. Use the Custom Clip id for subsequent /music-fetch, /add, /play, /share, and /download events.

At step 2, we recommend defaulting the start/end points to the same timestamps as the Curated Clip. This way, your user can have a head start tweaking the clip to their liking from the best part of the song. This is also preferred UX because the user will start the Custom Clipping experience hearing the same exact section of a track that plays during a preview.

Accessing the Curated Clip times

The /track-fetch response contains a curatedClip object, which provides the following parameters that will provide the relevant data to inform your custom clipping UI of the correct start/end points:

    "startMs": {
    "type": "number",
    "description": "Start offset in milliseconds from the beginning of the track"
    },
    "stopMs": {
    "type": "number",
    "description": "Stop offset in milliseconds from the beginning of the track"
    },
    "id": {
    "type": "number",
    "description": "Unique identifier for the curated clip"
    }